home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 3 / Light ROM 3 - Disc 2.iso / programs / amiga / titlers / vidtitlr / vidtitlr.lha / VIDEOTITLER / VideoTitler.doc < prev    next >
Text File  |  1994-04-15  |  19KB  |  392 lines
  1. #############################################################################
  2. #                                                                           #
  3. # V         V III DDDD   EEEEE   OO      TTTTT III TTTTT L     EEEEE RRRR   #
  4. #  V       V   I  D   D  E      O  O       T    I    T   L     E     R   R  #
  5. #   V     V    I  D    D E     O    O      T    I    T   L     E     R   R  #
  6. #    V   V     I  D    D EEE   O    O III  T    I    T   L     EEE   RRRR   #
  7. #     V V      I  D   D  E      O  O       T    I    T   L     E     R  R   #
  8. #      V      III DDDD   EEEEE   OO        T   III   T   LLLLL EEEEE R   R  #
  9. #                                                                           #
  10. #                      V         V     11     11                            #
  11. #                       V       V     1 1    1 1  x   x                     #
  12. #                        V     V     1  1   1  1   x x                      #
  13. #                         V   V     1   1  1   1    x                       #
  14. #                          V V          1      1   x x                      #
  15. #                           V           1 o    1  x   x                     #
  16. #                                                                           #
  17. #                       ⌐ 1993,94 by Andreas Ackermann                      #
  18. #                                                                           #
  19. #############################################################################
  20.  
  21.  o Copyright:
  22.  
  23.    VideoTitler is SHAREWARE.
  24.    THIS UNLIMITED VERSION MAY NOT BE DISTRIBUTED IN ANY RESPECT. IF IT SHOULD
  25.    APPEAR ON ANY PD-SERIES OR IN A MAILBOX I'LL TAKE JURIDICAL STEPS.
  26.  
  27.    I DONT'T TAKE ANY WARRANTY FOR ANY LOSS OF DATA RESULTING FROM USING THIS
  28.    PROGRAMM. I CANNOT GUARANTEE THAT THIS PROGRAMM IS ENTIRELY BUG-FREE.
  29.    ANY USAGE IS AT YOUR OWN RISK !!! NO EXCHANGE !!!
  30.  
  31.  o What is VideoTitler V1.15 ?
  32.  
  33.    VideoTitler V1.15 ( from now on referred as Vtt ) is a simple program to
  34.    generate professional looking TV end titles and credits.
  35.    Vtt allows you to scroll ANY font you like ( even colorfonts are suppor-
  36.    ted !) from the bottom to the top of a 736*560 pixels sized screen.
  37.    You may choose between four speeds.
  38.    Unfortunately scrolling of brushes is not supported yet.
  39.  
  40.  o How are the titles defined ?
  41.  
  42.    In the ScriptEditor you enter your text to be scrolled line per line.
  43.    Besides you may define the centering for each line ( left, middle, right ).
  44.    In the StyleEditor you define your font, font attributes ( outline, shadow,
  45.    normal ) and the color palette.
  46.    Having defined such a 'style' you may assign it to any number of textlines
  47.    you like.
  48.  
  49.  o Which system configuration is required ?
  50.  
  51.    Vtt runs on ANY Amiga, equipped at least with Kickstart 1.2. If you won't
  52.    use colorfonts even 512k of memory will do.
  53.    The more chip-ram you have the more fonts you may use within a script.
  54.    ( With 1 MB you shouldn't have any problems ! )
  55.  
  56.  After this quick survey, here is the complete reference:
  57.  
  58.  o any numbers that have to be typed in are taken as pixels. The display has
  59.    got a width of 736 and a height of 560 pixels ( approximately 450 on NTSC-
  60.    Amigas); as the overscan-mode is used, the 20 leftmost and rightmost and
  61.    5 pixels on the top and at the bottom are invisible, so if a textline
  62.    should just fit onto the screen this won't necessarily mean that it will
  63.    be entirely visible on the TV-screen.
  64.  
  65.  I. Loading, saving and executing scripts
  66.  
  67.    With the menu item 'Load...' you may load one of the provided  scripts,
  68.    ( located in the drawer 'scripts' ) and with 'Save...' you may save your
  69.    scripts.
  70.    Already when loading your script, Vtt tries to load the fonts used within
  71.    it, so this will take some time ( especially with floppy drives ).
  72.    If Vtt should fail to load a font, a requester will inform you about this.
  73.    Klicking on the 'Play' gadget pops up a requester that allows you to
  74.    specify the scrolling speed ( 50, 100, 200 and 300 pixels per second.
  75.    After that your screen will show the background color defined in your
  76.    script. All you have to do is to press the left mouse button and your
  77.    text will be scrolled in. Pressing the right mouse button will cause the
  78.    script to hold. Another mouse click (right button ) will restart it. By
  79.    clicking the left button you'll return to the script editor.
  80.    'Play current' works similar to 'Play'; however scrolling starts at the
  81.    current textline and your script will be scrolled in an endless loop.
  82.  
  83.    If your Amiga shouldn't be fast enough to generate a line of text , Vtt
  84.    automatically inserts some free lines ( happens mainly when you scroll
  85.    at a speed of more than 100 pixels/sec, with outlined fonts or with
  86.    colorfonts )
  87.  
  88.    If there's not enough memory Vtt will inform you about this. In this case
  89.    you only can try to make it with less fonts, as especially colorfonts eat
  90.    very much memory.
  91.  
  92.  II. Editing scripts
  93.  
  94.    On the left of Vtt's window you've got a box where you may select each line
  95.    of your title.
  96.    When starting Vtt there aren't any lines yet. You may change this by
  97.    klicking on 'Add Text'.
  98.    On the right, there will appear additional gadgets:
  99.  
  100.    curr. line: here you may edit your line of text at pleasure
  101.  o x-position: Centering is |    LEFT     |    RIGHT     |   MIDDLE
  102.                distance of  | left border | right border |  ignored
  103.  
  104.  o y-Distance: specifies the number of blank lines to be scrolled, before
  105.                the next text line appears
  106.  
  107.  o cur. Style: defines the 'Style' of this line; may be changed by selecting
  108.                'Edit Style'.
  109.  
  110.    Beyond the stringgadget there is some information about the dimensions of
  111.    the textline; if it is printed blue, there either is no font loaded
  112.    or this line won't fit onto the screen.
  113.    [Values for YPos etc. don't have any meaning in his version.]
  114.  
  115.    Beyond the select box there is another number of gadgets, that allow you
  116.    to modify the sequence of the textlines:
  117.  
  118.  o Copy   after activating 'Copy' Vtt waits for another line to be chosen.
  119.           The current line will be copied BEHIND this line, but still will
  120.           be preserved at its former position. The copy will become the
  121.           new current line.
  122.  o Move behind
  123.           works the same as 'Copy', but the original line will be deleted
  124.  o Move front
  125.           works the same as 'Move behind', but the copy will be inserted
  126.           IN FRONT of its destination.
  127.  
  128.    Selecting any of these gadgets a second time after activating it will
  129.    abort the action.
  130.  
  131.  o Delete deletes the current textline; the next line becomes current line
  132.  o Add Text
  133.           inserts a new line of text AFTER the current line
  134.  
  135.    Some words about the menus:
  136.  
  137.  o Bubble        (de)activates wavy scrolling mode
  138.  o Copperbars    Vtt won't show the background-color defined. Therefore it
  139.                  shows a black screen with two copperbars scrolling up and
  140.                  down. Very remarkable !
  141.  o Coppercycle   produces a rainbow-like color slide in the background. How-
  142.                  ever it does only look good in combination with huge fonts !
  143.  o Add Text      does the same as 'Add Text' Gadget
  144.  o Select next   selects the following line
  145.  o Select back   selects the previous line
  146.  
  147.  
  148.  III. The Style-Editor
  149.  
  150.    To enter the style-editor simply click on 'Edit-Style'. In the select-box
  151.    the styles already defined will appear ( when no script is loaded, there
  152.    won't be any styles ! )
  153.    Clicking on 'Add Style' defines a new style. On the right there will appear
  154.    a couple of gadgets:
  155.  
  156.  o Stylename    here you may enter a name for your style ( it's unsignificant
  157.                 for Vtt; it's just for better survey; its first character will
  158.                 be displayed in the script-editor right after the textline )
  159.  
  160.  o Style        the font's style is defined by this gadget:
  161.  
  162.    - 'Normal':   neither outline nor shadow
  163.                  the following three gadgets are meaningless in this case
  164.    - 'Shadow':   the textline appears with a shadow (bottom-right)
  165.                  'X-OFFSET' defines displacement to the right in pixels
  166.                  'Y-OFFSET' defines displacement downwards in pixels
  167.                  'DEPTH OF SHADOW' defines how often this action has to be
  168.                  repeated
  169.  
  170.       Example:   D.o.S.: 1, x-O: 12, y-O: 12
  171.                  Result: cast shadow, its displacements down and right are
  172.                  equal ( one pixel in y-direction is nearly as much as one
  173.                  pixel in x-direction )
  174.                  D.o.S.: 5, x-O: 2, y-O: 2 3-D-effect
  175.                  D.o.S.: 5, x-O: 0, y-O: 2 shadow only towards the bottom
  176.                  The best thing to get a feeling how these values work is to
  177.                  try out !!! ( negative inputs are unfotunately ignored !!! )
  178.    - 'Outline'   the font appears outlined
  179.                  'X-OFFSET' once more defines the displacement to the right
  180.                  [ however only 2 makes sense !]
  181.                  'Y-OFFSET' the same, just to the bottom  [ mainly set to 2]]
  182.                  'FATNESS OF OUTLINE' tells Vtt how often this action should
  183.                  be repeated [ values from 1 to 3 make sense; IMPORTANT:
  184.                  a 68000er Amiga isn't fast enough for values > 1 ; with
  185.                  scrolling speed set at more than 100pix/sec you even might
  186.                  get problems with 1 ! ]
  187.                  Hint: If you desire the outline, but the font itself should
  188.                        be transparent, simply choose the first colour of the
  189.                        palette as textcolor.
  190.  o Character Space:
  191.                  space between two characters; mainly 0 but especially with
  192.                  'Outline' and 'Shadow' bigger values make sense.
  193.  
  194.  o Pattern:      activating this gadget causes Vtt to use a pattern for the
  195.                  font, so that the original video will shine right through
  196.                  the font. However this switch won't affect shadows, outlines
  197.                  and color-fonts.
  198.  
  199.  o Font:         that's the name of the font used in this style. When printed
  200.                  blue, there's either no font selected or no font loaded.
  201.  
  202.  o Load Font:    used to select a font
  203.  
  204.  o Color-Editor: makes you enter into the palette-editor, allowing you to
  205.                  define a 8-colour palette JUST FOR THIS STYLE !
  206.  
  207.  o With 'Ok' you return to the script-editor. The current style will be
  208.    attributed to the current textline.
  209.  
  210.  
  211.  IV. The Color-Editor
  212.  
  213.   You edit an 8 color palette as usual by modifying the rgb portions of the
  214.   color.
  215.   The first color of the palette represents the background; changing it will
  216.   affect this color in each other style. Since V1.1 it's even possible to de-
  217.   fine a slide for this color.
  218.   If the style attached to this palette shouldn't include a colorfont, please
  219.   use ONLY THE FIRST FOUR colors of the palette, as the other ones are
  220.   ignored and the textline won't be shown correctly.
  221.   Foreground color and background color are defined by first clicking on the
  222.   desired color and then clicking on the gadget on the left of 'Textfarbe'.
  223.  
  224.  o Slade:        allows you to define a color as slide from one color to
  225.                  another.
  226.                  Activating it, a new gadget will appear allowing you to
  227.                  switch between start and endcolor.
  228.                  [ Slades from red to blue or red to yellow look best ! ]
  229.                  With your font being higher than 30 pixels you'll notice
  230.                  some stripes in the result, as the old graphic-chips don't
  231.                  provide enough colors.
  232.             NEW: This 'stripyness' won't appear when you're one of the proud
  233.                  owners of an Amiga 1200 or 4000 which is equipped with the
  234.                  new AGA-Chipset.
  235.  
  236.  o ColorFonts-Colors:
  237.                  If the font defined for this style should be a colorfont,
  238.                  you'll get its palette by clicking on this gadget.
  239.  
  240.  o With 'Ok' you return to the Style-Editor.
  241.  
  242.  
  243.  Some words about the fonts:
  244.  
  245.     The fonts included were downloaded from a mailbox that only provides
  246.     freely distributable stuff. However, there was no copyright notice found,
  247.     neither as file accompanying the fonts nor inside the font-files. So
  248.     the author BELIEVES that these fonts are freely distributable but however
  249.     he cannot guarantee it.
  250.  
  251.  Known BUGS:
  252.  
  253.  o  Select next/back won't scroll the viewable textlist
  254.  o  with some colorfonts, outlines and shadows won't be displayed correctly
  255.     Help: simply type in one or two spaces at the end and in front of this
  256.           textline ( required when using ChiselScript.font )
  257.  o  using a font in several styles will cause the font to be loaded in memory
  258.     several times. This is waste !
  259. !o! sometimes inexplicable system crashes
  260.  o  when scrolling at 100 pix/sec, Vtt probably will insert additional lines
  261.     of space, as a normal Amiga is too slow.
  262. !o! if you run out of memory while loading a script your system might crash
  263. !o! NEVER use more than 120 lines of text or more than 20 styles !
  264.     Otherwise: Crash ( don't tell me I didn't warn you ! )
  265.  o  *any* music replay will be stopped, while Vtt is playing as it requires
  266.     *all* the power of an MC68000. Maybe I'll include my own replay for
  267.     MED and SoundtrackerModules one day.
  268.  o  While Vtt is playing a script it takes over the whole machine. Any trans-
  269.     action with peripheral devices ( Modem, Printer, etc.) will stop.
  270.  
  271.  
  272.  
  273.  Ideas for future versions:
  274.  
  275.  o  16 colors or maybe even more (only AGA-Amigas !!!)
  276.  o  New styleguide-like user interface
  277.  o  scrolling of brushes
  278.  o  TV-station logo support
  279.  
  280.  -  The new version will require Kickstart 2.0 or higher, no matter whether
  281.     you use AA-Chips or not !
  282.  
  283.  About the program:
  284.  
  285.  I focussed on the result of this programm - a great looking result - and I
  286.  belive I achieved this goal. However this piece of software isn't free of
  287.  bugs and the user interface is not one of the best, I know.
  288.  
  289. ****************************** IMPORTANT *************************************
  290. *                                                                            *
  291. ************************* Changes since V1.0c ********************************
  292.  
  293.  o Vtt now uses a 736*560 pixels large hires-interlace screen, to get the best
  294.    quality possible for genlocking on an Amiga. The flickering of the image
  295.    on your monitor doesn't affect the result finally saved on your video tape.
  296.  o Vtt now supports the new color palette of the AGA-Amigas, which means that
  297.    *any* color slide may be shown without stripes as Vtt uses the full 24Bit
  298.    palette.
  299.  o You now may define color slides even for the background color. However this
  300.    only makes sense with AGA-Amigas.
  301.  o Vektor fonts are now supported.
  302.  o a bug in the fontmanagement has been removed: font-files larger than 65535
  303.    bytes now are handled correctly.
  304.  o the problem with the 'fast' mouseclicks to start a script on turbo-Amigas
  305.    now has been fixed once and forever.
  306.  o an english user-interface to make Vtt available for ALL users. ( Later I
  307.    intend  to lokalize the whole package.)
  308.  o the 'Bubble' menu item. Provides some kind of wavy scrolling, which does
  309.    look fine when being used with large fonts at a scrolling speed of 100
  310.    Pixels/sec.
  311. NEW for V1.11
  312.  o Copperbar background
  313.  o Coppercycle background
  314.  
  315.  New bugs and things that aren't the way they should be :
  316.  
  317.  o occasionally Vtt happend to crash on my old A500 when returning from the
  318.    scrolling routine. However I haven't had *any* crash when using Vtt on my
  319.    new A4000.
  320.  o Memory management now is done dynamically. Memory won't be allocated until
  321.    the textline really is to be shown. For this reason it's not easy to cal-
  322.    culate the maximum amount of memory needed, so Vtt only makes a guess
  323.    whether there is enough memory or not.
  324.    If Vtt should run out of memory while running, it simply tries to generate
  325.    the line after the line making trouble. Unfortunatly there isn't a way
  326.    (yet) to inform the user which line hasn't been displayed.
  327.  o When using non-color-fonts you may edit 8 colors in the color editor,
  328.    although only the first 4 colors are taken into account by the scroll-
  329.    routine. So be careful to define only the first 4 colors as text or shadow
  330.    color.
  331.  o Vtt *must* be run on an PAL or NTSC screen. However it's only the Color-
  332.    Editor which is making trouble, so if you won't use it you won't meet
  333.    any problems. Note: The Color-Editor doesn't even support Superhires !
  334.  o The rgb components of the colors only may take values from 0 to 15;
  335.    AGA support does 'only' comprise the generating of 24-bit colorslides.
  336.  o Colorslides only are possible for the first three colors; a specification
  337.    of a slide for any other color will be ignored.
  338.  
  339.  o The screenmode under which your script is played depends on a flag set
  340.    by the graphics system on bootup.( Power frequency: 60 Hz = USA => NTSC;
  341.    50 Hz = Europa => PAL) OS3.0 users may change this flag in the bootup
  342.    menu. All the others can use Nico Franτois' NTSC-PAL ( Fish 387 ).
  343.    Having an NTSC-screen opened on an PAL-Amiga or vice versa won't keep
  344.    Vtt from taking the correct mode ( i.e. the one specified on bootup or
  345.    or by NTSC-PAL ).
  346.  
  347. ******************************************************************************
  348.  
  349.  Vtt is (still) written in Assembler at 100% ( Devpac 2.0 ) on an A500 1.2
  350.  with 1 MB ram. ( Latest parts on A4000/EC 030)
  351.  It uses the reqtools.library which is ⌐opyrighted  by Nico Franτois. The
  352.  author is registered as developper.
  353.  
  354.  And now greetings to some people who made it possible to create Vtt:
  355.  
  356.  Franz Langheinrich of AmiTech Systems Hof/Bavaria (Testruns on A1200,
  357.                      technical and material support )
  358.  J.M. Forgeas      ( Editor AZ 1.5 )
  359.  Joe Siebenmann    ( EZAsm 1.7 ) ( Where is V1.8 you promised me long ago ?! )
  360.  Nico Franτois     ( reqtools.library, NTSC-PAL )
  361.  Jan van den Baard ( PowerSource )
  362.  Uwe Colditz       ( Ironmaster of Attack; ideas for fixing a major bug )
  363.  
  364.  History:
  365.  
  366.  V1.0b    7.4.'93
  367.           first release as limited demoversion after half a year of *BUSY*
  368.           work
  369.  V1.0c    14.4.'93
  370.           Fontrequest: the palette won't be changed any more with colorfonts
  371.           on turbo-Amigas Vtt sometimes refused to start the script;
  372.           this bug has been solved ( at least I hope !!! )
  373.  V1.1     AGA-Amiga-support and usage of an interlaced display for better
  374.           output quality; Bubble-Effect.
  375.  V1.11    during october 1993:
  376.           some bug fixes; copper-background support
  377.  V1.12    20.11.93
  378.           now you really may use left and right centered texts
  379.  V1.13    27.11.93
  380.           added possibility to stop scrolling with right mouse button
  381.  V1.14    during 1/94
  382.           some bug fixes
  383.  V1.15    6.2.94
  384.           some more bug fixes; now the right mouse button works like a switch
  385.           when the script is scrolled: one click will stop the script, another
  386.           will restart it.
  387.  
  388.                                                       Oberkotzau, 9.2.94
  389.  
  390.  
  391.  
  392.